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(57) Abstract: A system architecture (10) for thwarting denial of service attacks on a victim data center (20) is described. The 
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traffic statistics to identify malicious network traffic. A gateway (26) is disposed to protect the victim site. 
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MONITORING NETWORK TRAFFIC DENIAL OF SERVICE ATTACKS 

Background 

5 This invention relates to techniques to thwart 

network-related denial of service attacks. 

In denial of service attacks, an attacker sends a 
large volume of malicious traffic to a victim. In one 
approach an attacker, via a computer system connected to 

10 the Internet infiltrates one or a plurality of computers 
at various data centers. Often the attacker will access 
the Internet through an Internet Service Provider (ISP) . 
The attacker by use of a malicious software program places 
the plurality of computers at the data centers under its 

15 control. When the attacker issues a command to the 

computers at the data centers, the machines send data out 
of the data centers at arbitrary times. These computers 
can simultaneously send large volumes of data over various 
times to the victim preventing the victim from responding 

20 to legitimate traffic. 

Summary 

According to an aspect of the invention, a data 
collector includes a device to sample packet traffic. The 

25 device can accumulate and collect statistical information 
about network flow. The data collector also includes a 
port to link the data collector over a redundant network 
to a central control center. 

According to an additional aspect of the invention, a 

30 data collector to sample packet traffic, accumulate, and 
collect statistical information about network flows 
includes a computing device that executes a computer 
program product stored on a computer readable medium. The 
product includes instructions to cause the computing 
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device to perform sampling and statistic collection of 
data pertaining to network packets and parse the 
information in the sampled packets and maintain the 
information in a log. The device also includes a port to 
5 link the data collectors over a redundant network to a 
central control center. 

According to an additional aspect of the invention, a 
method of collecting data from sampled network traffic, 
pertaining to network traffic flows includes sampling the 

10 network traffic and generating statistics pertaining to 
the sampled network packets and communicating the 
generated statistics over a redundant network to a central 
control center. 

According to an additional aspect of the invention, a 

15 computer program product resides on a computer readable 
medium. The product controls a data collector to sample 
packet traffic, accumulate, and collect statistical 
information about network flows. The product includes 
instructions for causing the data collector to perform 

20 sampling and statistic collection of data pertaining to 
network packets. The product also includes instructions 
to parse the information in the sampled packets and 
maintain the information in a log. The product permits 
the device to communicate statistics generated by the data 

25 collector to a central control center over a redundant 
network. 

One or more aspects of the invention may provide some . 
or all of the following advantages. 

Aspects of the invention provide a distributed rather 
30 than a point solution to thwarting denial of service 
attacks. The technique can stop attacks near their 
source, protecting the links between the wider Internet 
and the attacked data center as well as devices within the 
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data center. The data collectors can be located inter 
alia, at major peering points and network points of 
presence (PoPs) . The data collectors sample packet 
traffic, accumulate, and collect statistical information 
5 about network flows. The data collector can respond to 
queries concerning characteristics of traffic on the 
network or can be request ed to down load via a hardened 
network the accumulated statistical information collected. 

10 Brief description of the drawings 

FIG. 1 is a block diagram of networked computers 
showing an architecture to thwart denial of service 
attacks. 

FIG. 2 is a block diagram depicting details of 
15 placement of a gateway. 

FIG. 3 is a block diagram depicting details of 
placement of data collectors. 

FIG. 4 is flow chart depicting a data collection 
process. 

20 FIG. 5 is a flow chart depicting details of a control 

center. 

FIG. 6 is a diagram depicting functional layers of a 
monitoring process. 

FIG. 7 is a diagram depicting one technique to gather 
25 statistics for use in algorithms that determine sources of 
an attack. 

FIG. 8 is a diagram depicting an alternative 
technique to gather statistics for use in algorithms that 
determine sources of an attack. 
30 FIG. 9 is flow chart depicting a process to determine 

receipt of bad TCP traffic. 

FIG. 10 is flow chart depicting a process to defend 
against setup time connection attacks. 
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Detailed Description 
Referring to FIG. 1, an arrangement 10 to thwart 
denial of service attacks (DoS attacks) is shown. The 
5 arrangement 10 is used to thwart an attack on a victim 
data center 12, e.g., a web site or other network site 
under attack. The victim 12 is coupled to the Internet 14 
or other network. For example, the victim 12 has a web 
server located at a data center (not shown) . 

10 An attacker via a. computer system 16 that is 

connected to the Internet e.g., via an Internet 14 Service 
Provider (ISP) 18 or other approach, infiltrates one or a 
plurality of computers at various other sites or data 
centers 20a-20c. The attacker by use of a malicious 

15 software program 21 that is generally surreptitiously 
loaded on the computers of the data centers 20a-20c, 
places the plurality of computers in the data centers 20a- 
20c under its control. When the attacker issues a command 
to the data centers 20a-20c, the data centers 20a-20c send 

20 data out at arbitrary times. These data centers 20a-20c 
can simultaneously send large volumes of data at various 
times to the victim 12 to prevent the victim 12 from 
responding to legitimate traffic. 

The arrangement 10 to protect the victim includes a 

25 control center 24 that communicates with and controls 

gateways 2 6 and data collectors 28 disposed in the network 
14. The arrangement protects against DoS attacks via 
intelligent traffic analysis and filtering that is 
distributed throughout the network. The control center 24 

30 is coupled to the gateways 26 and data collectors 28 by a 
hardened, redundant network 30. Gateways 26 and data 
collectors 28 are types of monitors that monitor and 
collect statistics on network traffic. In preferred 
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embodiments, the network is inaccessible to the attacker. 
The gateway 26 devices are located at the edges of the 
Internet 14, for instance, at the entry points of data 
centers. The gateway devices constantly analyze traffic, 
5 looking for congestion or traffic levels that indicate the 
onset of a DoS attack. The data collectors 28 are located 
inter alia at major peering points and network points of 
presence (PoPs) . The data collectors 28 sample packet 
traffic, accumulate, and collect statistical information 

10 about network flows. 

All deployed devices e.g., gateways 26 and data 
collectors 28 are linked to the central control center. 
The control center aggregates traffic information and 
coordinates measures to track down and block the sources 

15 of an attack. The arrangement uses a distributed analysis 
emphasizing the underlying characteristics of a DoS 
attack, i.e., congestion and slow server response, to 
produce a robust and comprehensive DoS solution. Thus, 
this architecture 10 can stop new attacks rather than some 

20 solutions that can only stop previously seen attacks. 
Furthermore, the distributed architecture 10 will 
frequently stop an attack near its source, before it uses 
bandwidth on the wider Internet 14 or congests access 
links to the targeted victim 12 . 

25 A virus is one way to get attacks started. When 

surfing the web page a user may download something, which 
contains a virus that puts the user's computer under the 
control of some hacker. In the future, that machine can 
be one of the machines that launches the attack. The 

30 attacker only needs a sufficient amount of bandwidth to 
get a sufficient number of requests out to the victim 12 
to be malicious. 
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Referring to FIG. 2, details of an exemplary 
deployment of a gateway is shown. Other deployments are 
possible and the details of such deployments would depend 
on characteristics of the site, network, cost and other 
5 considerations. The gateway 26 is a program executing on 
a device, e.g., a computer 27 that is disposed at the edge 
of the data center 20 behind an edge router at the edge of 
the Internet 14. Additional details on the gateway 26 are 
discussed below and in the APPENDIX A. In a preferred 

10 embodiment, a plurality of gateway devices are deployed at 
a corresponding plurality of locations, e.g., data centers 
or sites over the network, e.g., the Internet 14. There 
can be one gateway or a plurality of gateways at each data 
center, but that is not necessarily required. 

15 The gateway 26 includes a monitoring process 32 (FIG. 

6B) that monitors traffic that passes through the gateway 
as well as a communication process 33 that can communicate 
statistics collected in the gateway 26 with the data 
center 24. The gateway uses a separate interface over a 

20 private, redundant network, such as a modem 39 to 

communicate with the control center 24 over the hardened 
network 30. Other interface types besides a modem are 
possible. In addition, the gateway 26 can include 
processes 35 to allow an administrator to insert filters 

25 to filter out, i.e., discard packets that the device deems 
to be part of an attack, as determined by heuristics 
described below. 

An attack can be designed to either overload the 
servers or overload some part of the network 

30 infrastructure inside the victim site 12. Thus, the 
victim site 12 can include routers, switches, load 
balancers and other devices inside the data center that 
can be targeted by the attack. A particularly troublesome 
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attack causes overload of upstream bandwidth. Upstream 
bandwidth is the capacity between the victim 12 data 
center 12a and one or a plurality of routers or switches 
belonging to the victim 12 data center's network service 
5 provider, which provides connectivity to the rest of the 
network, e.g., the Internet. 

For an exemplary configuration, the victim site 12 
can include a plurality of high bandwidth lines feeding a 
GSR (Gigabit Switch Router) . At the output of the GSR are 

10 exit ports to various parts of the data center. The GSR 
is generally very high bandwidth and generally does not 
crash. The gateway 26 is placed behind the GSR and across 
some or all of the output ports of the GSR into the data 
center. This configuration allows the gateway 26 to 

15 monitor and control some or all of the traffic entering 
the data center without the need to provide routing 
functionality. 

Alternatively, a gateway 26 can tap a network line 
without being deployed physically in line, and it can 

20 control network traffic, for example, by dynamically 
installing filters on nearby routers. The gateway 26 
would install these filters on the appropriate routers via 
an out of band connection, i.e. a serial line or a 
dedicated- network connection. Other arrangements are of 

25 course possible. 

Referring to FIG. 3, data collectors 28 are shown 
coupled to the network to tap or sample traffic from data 
centers 20a-20c. Although data collectors 28 can be 
dispersed throughout the network 14 they can be 

30 strategically disposed at peering points, i.e., points 

where network traffic from two or more different backbone 
providers meet. The data collectors 28 can also be 
disposed at points of presence (PoPs) . The data 
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collectors 28 monitor and collect information pertaining 
to network traffic flow. The data collectors process 
statistics based on monitored network traffic that enters 
a peering point. Data collectors 28 include a monitoring 
5 process 32 (FIG. 6) as well as a communication process 
that communicates data to the control center over the 
hardened network 30. One or more data collector devices 
28 use the monitoring process to monitor one or more lines 
that enter the peering point. Each data collector 28 

10 would be able to monitor one or more lines depending on 
the specifics of how the network is configured and 
bandwidth requirements . 

The gateway 26 and data collector 26 are typically 
software programs that are executed on devices such as 

15 computers, routers, or switches. In one arrangement , 

packets pass through the gateway 26 disposed at the data 
center 22a and are sampled by the data collector. 

Referring to FIG. 4, the data collector 2 6 performs 
40 a sampling and statistic collection process 40. The 

20 data collector samples 42 one (1) packet in every (n) 

packets and has counters to collect statistics about every 
packet. The data collector 26 parses the information in 
the sampled packet. Information collected includes source 
information 44, which may be fake or spoofed, e.g., not 

25 correct information. It will also include destination 
information 46, which generally is accurate information. 
The data collector 28 collects that information but need 
not log the sampled packets. The data collector 28 
maintains a log over a period of time, e.g., in the last 

30 hour. As an example, the log that the data collector 26 
maintains is a log that specifies that the data collector 
has seen a certain number of packets, e.g., 10,000 packets 
of a particular kind, that apparently originated from a 
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particular source (s) that are going to a particular 
destination. 

Based on rules 48 within the data collector 26, the 
data collector 26 analyzes 50 the collected statistics and 
5 may if necessary compose 52 a message that raises an 

alarm. Alternatively, the data collector can respond to 
queries concerning characteristics of traffic on the 
network. Typically, the queries can be for information 
pertaining to statistics. It can be in the form of an 

10 answer to a question e.g., how many packets of a type did 
the data collector see or it can be a request to down load 
via the hardened network, the entire contents of the log. 
One rule is that when the data collector 26 starts 
sampling, the data collector periodically logs data and 

15 produces a log of a large plurality of different network 
flows over a period of time. 

Referring to FIG. 5, a deployment for the control 
center 24 is shown. The control center 24 receives 
information from one or more gateways 26 and data 

20 collectors 28 and performs appropriate analysis using an 
analysis process 62. The control center is a hardened 
site. 

The control center 24 has multiple upstream 
connections so that even during an attack it will have 

25 other ways to couple to the network 30. Several 

approaches can be used to harden the site. One approach 
can use special software between the site and the Internet 
14 to make it immune to attack. An approach is to have a 
physically separate network 30 connected to all of the 

30 devices, e.g., gateways 26 and data collectors 28. One 
exemplary embodiment of that physically separate network 
30, which is hardened, is the telephone system. Thus, 
each one of the data collectors 26 and gateways 26 
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includes an interface to the separate network, e.g., a 
modem. The data center 26 also includes a corresponding 
interface to the separate network, e.g., a modem or a 
modem bank 60. 

5 With this approach, the redundant network 30 is not 

accessible to the attacker. The redundant network 30 thus 
is available to communicate between the data center 24 and 
data collectors and gateways to coordinate response to an 
attack. In essence, the network 30 used by the data 

10 center to communicate with the data collectors 26 and 
gateways 26 is not available to the attacker. 
Alternatively, if less than complete assurance is 
required, the control center could be resistant to attack 
and still be connected to the Internet 14. 

15 The analysis process 62 that is executed on the 

control center 24 analyzes data from the gateways 26 and 
data collectors 28. The analysis process 62 tries to 
detect attacks on victim sites. The analysis process 62 
views attacks as belonging to, e.g., one of three classes 

20 of attack. Herein these classes of attack are denoted as 
low-grade with spoofing, low-grade without spoofing and 
high-grade whether spoofing or non-spoofing. 

A low-grade attack is an attack that does not take 
out upstream bandwidth. A low-grade attack does not 

25 significantly overburden the links between the Internet 14 
and the victim data center 12. The low-grade non-spoofing 
attack is the simplest type of attack to defend against. 
It simply requires identifying the source of the attack 
.and. a mechanism to notify an administrator at the victim 

30 site to install a filter or filters at appropriate points 
to discard traffic containing the source address 
associated with the attack. 
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With a low-grade spoof ing-type attack, an attacker 
sends an IP-packet to a destination but fakes the source 
address. There is no way to enforce use of an accurate 
source address by a sender. During a spoofing attack, 
5 each one of the attacking machines will send a packet with 
a fake, e.g., randomly selected or generated source 
address. Under this type of attack, the victim 12 alone 
cannot thwart the attack. An administrator at the victim 
12 can try to put a filter on a router to stop the 
10 packets. However, there is no way for the administrator 
to guess what the random address of the next packet will 
be. 

The control center 24 also includes a communication 
process 63 to send data to/ from the gateways 26 and data 

15 collectors 28. The gateway .26 at the victim 12 contacts 
the control center and notifies the control center 24 that 
the victim 12 data center is under a spoofing attack. The 
gateway 26 identifies itself by network address (e.g., 
static IP address if on the Internet 14), via a message to 

20 the control center 24. The message sent over the hardened 
network 30 indicates the type of attack, e.g., an attack 
from addresses that the victim 12 cannot stop because it 
is a spoofing type of attack. The control center queries 
data collectors 28 and asks which data collectors 28 are 

25 seeing suspicious traffic being sent to the victim 12. 

The packets from the attacker will have faked source 
addresses that will be changing with time. However, the 
control center can issue a query for this kind of packet 
by victim destination address. The data collectors 28 

30 reply with the information collected. Based on that 
collected information from the data collectors 28, the 
control center can then determine what data centers are 
performing the spoofing on the victim 12. 
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In the present configuration, there are two possible 
sources of attack traffic: either the attacker is behind a 
gateway 26 or not. If the attacker is behind a gateway 
26, the control center issues a request to the appropriate 
5 gateway 26 to block the attacking traffic, e.g. by 

allowing the appropriate gateway 26 to discard traffic, 
e.g., packets that contain the victim 12 destination 
address. The gateway 26 stops that traffic in a 
transparent manner. If the attacker is- not behind a 

10 gateway 26, data collectors 28 are used to provide 

information about possible locations of the attackers. 
The availability of information from data collectors 28 
increases the speed with which attackers are discovered. 
The data collectors 28 are positioned at network switching 

15 points that see a high volume of traffic, which minimizes 
the required number of deployed data collectors. 

The high-grade attacks are attacks that take out the 
link between the victim 12 data center and the Internet 
14. With a high-grade attack it does not matter whether 

20 the victim 12 is spoofed or not. Under a high-grade 

attack, the attack requires cooperation just like the low 
grade spoofing attack. Thus, the same thwarting mechanism 
is used for either spoofing or non-spoofing, e.g., using 
information from the data collectors 28 to identify 

25 attacking networks. This information is used to either 
automatically shutdown traffic having the victim's 
destination address at the appropriate gateways 26 or is 
used to identify networks or data centers from which the 
attack is originating and to follow up with calls to the 

30 appropriate administrators. 

Referring to FIG. 6, a monitoring process 32 is 
shown. The monitoring process 32 can be deployed on data 
collectors 28 as well as gateways 26. The monitoring 

-12- 
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process 32 includes a process 32a to collect statistics of 
packets that pass by the data collectors 28 or through the 
gateways 26. The monitoring process 32 also includes 
several processes 32b to identify, malicious traffic flows 
5 based on the collected statistics as further described 
below. 

Referring to FIG. 7 , the gateways 26 and data 
collectors 28 are capable of looking at multiple levels of 
granularity. The gateways 26 and data collectors have 

10 monitoring process 32 used to measure some parameter of 
traffic flow. One goal of the gateways 26 and data 
collectors 28 is to measure some parameter of network 
traffic. This information collected by the gateways 26 
and data collectors is used to trace the source of an 

15 attack. 

One of the algorithms to measure parameters of 
traffic flow divides the traffic flow into buckets. For 
example, consider one simple parameter, the count of how 
many packets a data collector or gateway examines. An 

20 algorithm to track the count of this parameter starts with 
a predefined number of buckets, e.g., M N" buckets. The 
buckets are implemented as storage areas in the memory 
space of the data collector or gateway device. The 
algorithm will use some hash function *£ (h)", which takes 

25 the packet and outputs an integer that corresponds to one 
of the buckets "Bi . B N ". Statistics from the packets start 
accumulating in the buckets "B x _ B N ". The buckets "B x - B N " 
are configured with threshold values "Th." As the 
contents of the buckets Bi - B N reach the configured 

30 thresholds values "Th", (e.g., compare values of packet 

count or packet rate to threshold) , the monitoring process 
32 deems that event to be of significance. The monitoring 
process 32 takes that bucket, e.g., B± and divides that 
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bucket Bi into some other number M of new buckets Bn - Bin- 
Each of the new buckets Bn . B iM contains values 
appropriately derived from the original bucket Bi. Also, 
the hash function is extended to map to N+M-l "h-N+M-l" 
5 values, rather than the original N values. 

An attack designed to use the algorithm of FIG. 6 
against a gateway 26 or a data collector 28 might send 
packets in such a fashion as to explode the number of 
buckets. Since each bucket consumes memory space, the 

10 attack can be designed to consume all available memory and 
crash the device, e.g., computer on which the monitoring 
process 32 executes. There are ways of preventing that 
type of attack on the monitoring process 32. One way is 
to make the hash function change periodically, e.g., 

15 randomly. Also the hash function is secret so that the 
packets are reassigned to different buckets in ways 
unknown to the attackers. 

Referring to FIG. 8, a second method is that instead 
of using just thresholds and values inside a given bucket, 

20 the monitoring process 32 also sets thresholds on the 

number of buckets. As the gateway 26 or data collector 28 
approaches a bucket threshold "Th", the gateway 26 or data 
collector 28 have the ability to take several buckets Bi - 
B 3 and divide them in more buckets Bi - B 4 or combine them 

25 into fewer bucket Bi _ B 2 . 

The function of the variable number of buckets is to 
dynamically adjust the monitoring process to the amount of 
traffic and number of flows, so that the monitoring device 
(e.g., gateway 26 or data collector 28) is not vulnerable 

30 to DoS attacks against its own resources. The variable 
number of buckets also efficiently identifies the 
source (s) of attack by breaking down traffic into 
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different categories (buckets) and looking at the 
appropriate parameters and thresholds in each bucket. 

Thus, with multi-level analysis as discussed in FIGS. 
6 and 7 , traffic is monitored at multiple levels of 
5 granularity, from aggregate to individual flows. Multi- 
level analysis can be applied to all types of monitoring 
(i.e. TCP packet ratios, repressor traffic, etc. discussed 
below) except TCP SYN proxying (because the latter 
requires per-connection monitoring of all half-open 

10 connections as discussed below) . 

The monitoring process 32 has the gateway 26 or the 
data collectors 28 keep track of a metric (such as packet 
ratio) for each of n traffic buckets. (If n=l, the 
monitoring process 32 tracks the metric for all traffic in 

15 the aggregate.) The monitoring process 32 places packets 
into buckets according to a hash function of the source or 
destination address. If the metric in any bucket exceeds 
a given "suspicious" threshold, that bucket is split into 
several smaller buckets, and the metric is tracked 

20 individually for each new bucket. In the limit, each 
bucket can correspond to a single flow (source 
address/port and destination address/port pair) . The 
resulting per-flow monitoring is resilient to denial-of- 
service attacks. If the number of buckets exceeds a given 

25 memory limit (for example, due to a many-flow spoofing 

attack) , several fine-grain buckets can be aggregated into 
a single coarse-grain bucket. The hash function for 
placing packets into traffic buckets is secret and changes 
periodically, thwarting attacks based on carefully chosen 

30 addresses . 

In the worst case, an attacker actually spoofs 
packets from all possible addresses. An IP address, for 
example is 32 bits long. This address length allows for 
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approximately 4 billion possible random addresses and 
makes it impossible for the gateway at the victim site 12 
to identify the attacker. In that worst case, the gateway 
26 calls the control center, indicates the address of the 
5 gateway 2 6, and conveys that the gateway 26 is receiving 
unreasonably high levels of random traffic- The control 
center 24 contacts the data collectors 28. The control 
center 24 analyzes the statistics collected by the data 
collectors 28 to try to determine the source of the 
10 traffic. 

Egress filtering is a recommended Internet 14 best 
practice procedure that does not allow any packets out of 
a network unless the source address, belongs to that 
network. Egress filtering prevents hosts on that network 

15 from sending out packets with completely random source 

addresses. Rather, the space of usable fake addresses is 
limited by the size of the host's network address space, 
and may range up to 24 bits rather than the full 32 bits. 
If an attacker is attacking from a network that performs 

20 egress filtering, then all the attack traffic reaching a 
victim will fall into a smaller number of buckets, those 
corresponding to the source network address. In this way, 
the gateway 26 can identify the approximate source of the 
attack without necessarily relying on the control center 

25 or data collectors. 

Several methods can be used separately or in 
combination to identify, malicious traffic flows. For 
example, the gateway 26 can detect DoS attacks and 
identify malicious flows or source addresses using at 

30 least one or more of the following methods including: 
analyzing packet ratios of TCP-like traffic; analyzing 
"repressor" traffic for particular types of normal 
traffic; performing TCP handshake analysis; performing 
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various types of packet analysis at packet layers 3-7; and 
logging/historical analysis. 

Packet ratios for TCP-like traffic. 
5 The Transmission Control Protocol (TCP) is a protocol 

in which a connection between two hosts, a client C, e.g. 
a web browser, and a server S, e.g. a web server, involves 
packets traveling in both directions, between C and S and 
between S and C. When C sends data to S and S receives 

10 it, S replies with an ACK ("acknowledgement") packet. If 
C does not receive the ACK, it will eventually try to 
retransmit the data to S, to implement TCP's reliable 
delivery property. In general, a server S will 
acknowledge (send an ACK) for every packet or every second 

15 packet. 

Referring to FIG. 9, the monitoring process in the 
gateway 26 can examine 82 a ratio of incoming to outgoing 
TCP packets for a particular set of machines, e.g. web 
servers. The monitoring process can compare 84 the ratio 

20 to a threshold value. The monitoring process can store 8 6 
this ratio, time stamp it, etc. and conduct an ongoing 
analysis 88 to determine over time for example how much 
and how often it exceeds that ratio. As the ratio grows 
increasingly beyond 2:1, it is an increasing indication 

25 that the machines are receiving bad TCP traffic, e.g. 
packets that are not part of any established TCP 
connection, or that they are too overloaded to acknowledge 
the requests. This ratio is one of the parameters 
measured using the multiple-bucket algorithm described 

30 previously. 

The gateway 26 divides traffic into multiple buckets, 
e.g. by source network address, and tracks the ratio of 
ingoing to outgoing traffic for each bucket. As the ratio 
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for one bucket becomes skewed, the gateway 26 may 
subdivide that bucket to obtain a more detailed view. The 
gateway 26 raises 90 a warning or alarm to the data center 
24 and/or to the administrators at the victim site 12. 

5 

Repressor traffic 

The phrase "repressor traffic" as used herein refers 
to any network traffic that is indicative of problems or a 
potential attack in a main flow of traffic. A gateway 26 

10 may use repressor traffic analysis to identify such 
problems and stop or repress a corresponding attack. 

One example of repressor traffic is ICMP port 
unreachable messages. These messages are generated by an 
end host when it receives a packet on a port that is not 

15 responding to requests. The message contains header 

information from the packet in question. The gateway 26 
can analyze the port unreachable messages and use them to 
generate logs for forensic purposes or to selectively 
block future messages similar to the ones that caused the 

20 ICMP messages. 

TCP handshake analysis 

A TCP connection between two hosts on the network is 
initiated via a three-way handshake. The client , e.g. C, 

25 sends the server, e.g. S, a SYN ("synchronize") packet. S 
the server replies with a SYN ACK ("synchronize 
acknowledgment") packet. The client C replies to the SYN 
ACK with an ACK ("acknowledgment") packet. At this point, 
appropriate states to manage the connection are 

30 established on both sides. 

During a TCP SYN flood attack, a server is sent many 
SYN packets but the attacking site never responds to the 
corresponding SYN ACKs with ACK packets. The resulting 
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"half-open" connections take up state on the server and 
can prevent the server from opening up legitimate 
connections until the half-open connection expires, which 
usually takes 2-3 minutes. By constantly sending more SYN 
5 packets, an attacker can effectively prevent a server from 
serving any legitimate connection requests. 

Referring to FIG. 10, in an active configuration, a 
gateway 26 can defend against SYN flood attacks. During 
connection setup, the gateway forwards 102 a SYN packet 

10 from a client to a server. The gateway forwards 104 a 
resulting SYN ACK packet from a server to client and 
immediately sends 106 ACK packet to the server, closing a 
three-way handshake. The gateway maintains the resulting 
connection for a timeout period 108. If the ACK packet 

15 does not arrive from client to server 110, the gateway 
sends 112 a RST ("reset") to the server to close the 
connection. If the ACK arrives 114, gateway forwards 116 
the ACK and forgets 118 about the connection, forwarding 
subsequent packets for that connection. A variable 

20 timeout 120 period can be used. The variable time out 
period can be inversely proportional to number of 
connections for which a first ACK packet from client has 
not been received. If gateway 26 is placed inline in the 
network, when number of non-ACK f ed connections reaches a 

25 configurable threshold 122, the gateway will not forward 
any new SYNs until it finishes sending RSTs for those 
connections . 

In a passive configuration, a gateway 26 can 
similarly keep track of ratios of SYNs to SYN ACKs and SYN 

30 ACKs to ACKs, and raise appropriate alarms when a SYN 
flood attack situation occurs. 

Layer 3-7 analysis. 
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With layer 3-7 analysis, the gateway 26 looks at 
various traffic properties at network packet layers 3 
through 7 to identify attacks and malicious flows. These 
layers are often referred to as layers of the Open System 
5 Interconnection (OSI) reference model and are network, 
transport, session, presentation and application layers 
respectively. Some examples of characteristics that the 
gateway may look for include: 

1. Unusual amounts of IP fragmentation, or fragmented 
10 IP packets with bad or overlapping fragment offsets. 

2. IP packets with obviously bad source addresses, or 
ICMP packets with broadcast destination addresses. 

3. TCP or UDP packets to unused ports. 

4. TCP segments advertizing unusually small window 
15 sizes, which may indicate load on server, or TCP ACK 

packets not belonging to a known connection. 

5. Frequent reloads that are sustained at a rate 
higher than plausible for a human user over a persistent 
HTTP connection. 

20 

Logging and historical traffic analysis 

The gateways 26 and data collectors 28 keep 
statistical summary information of traffic over different 
periods of time and at different levels of detail. For 

25 example, a gateway 26 may keep mean and standard deviation 
for a chosen set of parameters across a chosen set of 
time-periods. The parameters may include source and 
destination host or network addresses, protocols, types of 
packets, number of open connections or of packets sent in 

30 either direction, etc. Time periods for statistical 

aggregation may range from minutes to weeks . The device 
will have configurable thresholds and will raise warnings 
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when one of the measured parameters exceeds the 
corresponding threshold. 

The gateway 26 can also log packets. In addition to 
logging full packet streams , the gateway 26 has the 
5 capability to log only specific packets identified as part 
of an attack (e.g., fragmented UDP packets or TCP SYN 
packets that are part of a SYN flood attack) . This 
feature of the gateway 26 enables administrators to 
quickly identify the important properties of the attack. 

Building a DoS-resistant network 

The network of gateways 26, data collectors 28, and 
control center 24 are made DoS resistant by combining and 
applying several techniques. These techniques include the 

15 use of SYN cookies and "hashcash" to make devices more 
resistant to SYN floods and other attacks that occur at 
connection setup time. Also, the data center can use 
authentication and encryption for all connections. 
Private/public key pairs are placed on machines before 

20 deployment to avoid man-in-the-middle attacks. The 

control center 24 can have multiple physical connections 
from different upstream network service providers. The 
network over which the data center communicates between 
gateways and data collectors is a private redundant 

25 network that is inaccessible to attackers. 

Information exchange between gateways /data collectors 
and the control center is efficient by transferring only 
statistical data or minimal header information, and by 
compressing all data. 

30 This application includes an APPENDIX A attached 

hereto and incorporated herein by reference. APPENDIX A 
includes Click code for monitor software. 
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This application also includes an APPENDIX B attached 
hereto and incorporated herein by reference. APPENDIX B 
sets out additional modules for a Click. Router that 
pertains to thwarting DoS attacks. "Click" is a modular 
5 software router system developed by The Massachusetts 
Institute of Technology's Parallel and Distributed 
Operating Systems group. A Click router is an 
interconnected collection of modules or elements used to 
control a router's behavior when implemented on a computer 
10 system. 

Other embodiments are within the scope of the 
appended claims. 
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APPENDIX A 

network monitor/defender 

// 

5 // Has two operating modes: if MONITOR is defined, it monitors the network 
// instead of defending against DDoS attacks. 

// 

// ICMP_RATE specifies how many ICMP packets allowed per second. Default is 
// 500. UDP_NF_RATE specifies how many non-fragmented UDP (and other non- 
10 TCP 

// non-ICMP) packets allowed per second. Default is 3000. UDP_F_RATE specifies 
// how many fragmented UDP (and other non-TCP non-ICMP) packets allowed per 
// second. Default is 1000. All the SNIFF rates specify how many bad packets 
// sniffed per second. 
15 // 

// For example, if MONITOR is not defiend, and all SNIFF rates are 0, then the 
// configuration defends against DDoS attacks, but does not report bad 
// packets. 

// 

20 // can read: 

// - tcp_monitor: aggregate rates of different TCP packets 

// - ntcp_monitor: aggregate rates of different non TCP packets 

// - icmp_unreach_counter: rate of ICMP unreachable pkts 

// - tcp_ratemon: incoming and outgoing TCP rates, grouped by non-local hosts 

25 // - ntcpjratemon: incoming UDP rates, grouped by non-local hosts 
// 

// Note: handles full fast ethemet, around 134,500 64 byte packets, from 
// attacker. 

// 

30 // 

//TODO: 

// - fragmented packet monitor 



#imdefICMP_RATE 
35 #define ICMP_RATE 500 
#endif 

#imdefUDP_NF_RATE 
#define UDP_NF_RATE 2000 
40 #endif 

#imdefUDP_F_RATE 
#defineUDP_F_RATE 1000 
#endif 



45 



#imdefSUSP_SNIFF 

#define SUSP_SNIFF 1 00 // # of suspicious pkts sniffed per sec 
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#endif 

#ifedefTCP_SNIFF 

#define TCP_SNIFF 100 //#ofTCP flood pkts sniffed per sec 
5 #endif 

#ifodefICMP_SNIFF 

#define ICMP_SNIFF 75 // # of ICMP flood pkts sniffed per sec 
#endif 

10 

#ifndefUDP_NF_SNIFF 

#defineUDP_NF_SNIFF 75 // # of non-frag UDP flood pkts sniffed per sec 
#endif 

15 #ifndefUDPJF_SNIFF 

#define UDP_F_SMFF 75 // # of frag UDP flood pkts sniffed per sec 
#endif 

#include "if.click" 

20 

#include "sampler.click" 

^include "sniffer.click" 
ds_sniffer :: Sniffer(mazu_ds); 
25 syn_sniffer :: Sniffer(mazu_syn); 
tcp_sniffer :: Sniffer(mazu_tcp); 
ntcp_sniffer :: Sniffer(mazu_ntcp); 

#include "synkill.click" 
30 #ifdefMONITOR 

tcpsynkill :: SYNKill(true); 
#else 

tcpsynkill :: SYNKill(false); 
#endif 

35 

// 

// discards suspicious packets 

// 

40 

#include "ds.click" 

ds :: DetectSuspicious(Ol); 

from_world -> ds; 
45 ds [0] -> is_tcp_to_victim :: IPClassifier(tcp, -); 
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// 

// prevent SYN bomb 

// 

5 check_tcp_ratio [0] -> [0] tcpsynkill; 
tcp_ratemon [1] -> [1] tcpsynkill; 

tcpsynkill [0] -> to_victim_sl; 
tcpsynkill [1] -> tojworld; 

10 

tcpsynkill [2] 
#ifdefMONITOR 

-> synjsniffer; 
Idle -> tojvdctim_j>rio; 
15 #else 

-> tcpsynkill_split :: Tee(2) 
tcpsynkill_split [0] -> to_victim_prio; 
tcpsynkill_split [1] -> synjsniffer, 
#endif 

20 

// 

// monitor all non TCP traffic 

// 

25 ntcp_ratemon :: IPRateMonitor(PACKETS, 0, 1, 100, 4096, false); 

is_tcp_to_victim [1] -> ntcp_monitor :: NonTCPMonitor -> ntcp_t :: Tee(2); 
ntcp J: [0] -> [0] ntcp_ratemon [0] -> Discard; 
ntcpj [1] -> [1] ntcp_ratemon; 

30 // 

//rate limit ICMP traffic 

// 

ntcp_ratemon [1] -> isjcmp :: IPClassifier(icmp, -); 
35 isjcmp [0] -> icmp_split :: RatedSplitter (ICMP_RATE); 

icmp_split [1] -> to_victim_s2; 

icmpjsplit [0] -> icmp_sample : : RatedSampler (ICMPJSNIFF); 

40 icmp_sample [1] -> ntcp_sniffer; 

icmp_sample [0] 

#ifdefMONITOR 
-> to_victim_s2; 

#else 
45 -> Discard; 

#endif 
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#ifdef MONITOR 

ds [1] -> ds_split :: RatedSampler(SUSP_SNlFF); 
#else 

ds [1] -> ds_split :: RatedSpUtter(SUSP_SNIFF); 
5 #endif 

ds_split [1] -> ds_sniffer; 
ds_split [0] 
#ifdef MONITOR 
10 -> is_tcp_to_victim; 
#else 

-> Discard; 
#endif 

15 // 

//monitor TCP ratio 

// 

#include "monitor.click" 
20 tcp_ratemon :: TCPTrafBcMonitor; 

is_tcp_to_victim [0] -> tcp_monitor :: TCPMonitor -> [0] tcp_ratemon; 
from_victim -> is_tcp_to_world :: IPClassifier(tcp, -); 
is_tcp_to_world [0] -> [1] tcp_ratemon; 

25 

// 

// enforce correct TCP ratio 

// 

30 check_tcp_ratio :: RatioShaper(l, 2,40,0.2); 
tcp_ratemon [0] -> check_tcp_ratio; 

#ifdefMONITOR 

check_tcp_ratio [1] ->tcp_split :: RatedSampler(TCP_SNIFF); 
35 #else 

check_tcp_ratio [1] -> tcp_split :: RatedSplitter(TCP_SNIFF); 
#endif 

tcp_split [1] -> tcp_sni£fer, 
40 tcp_split [0] 

#ifdefMONITOR 
-> [0] tcpsynkill; 
#else 

-> Discard; 
45 #endif 
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// 

// rate limit other non TCP traffic (mostly UDP) 

// 

5 is_icmp [1] -> is_frag :: Classifier(6/0000, -); 

is_frag [0] -> udp_split :: RatedSplitter (UDP_NFJRATE); 

udp_split [0] -> udp_sample :: RatedSampler (UDPJ^JSNIFF); 
1 0 udp_sample [1] -> ntcp_sniffer; 

udp_sample [0] 

#ifdefMONITOR 
-> to_victim_s2; 

#else 
15 -> Discard; 

#endif 

is_frag [1] ->udpjf_split :: RatedSplitter (UDP _F_RATE); 

20 udp_f_split [0] -> udp_f_ sam P le :: RatedSampler (UDPJF_SNIFF); 
udp_f_sample [1] -> ntcp_sniffer; 
udp_fsample [0] 
#ifdefMONITOR 
-> to_victim_s2; 
25 #else 

-> Discard; 
#endif 

// 

30 // further shape non-TCP traffic with ICMP dest unreachable packets 

// 

is_tcp_to_world [1] -> is_icmp_unreach :: IPClassifier(icmp type 3, -); 
is_icmp_unreach [1] -> to_world; 
35 isjcmp_unreach [0] 

-> icmp_unreach_counter :: Counter; 

#ifiidefMONITOR 

40 icmp_unreach_counter -> icmperrjample :: RatedSampler (UNREACH_SNIFF); 

icmperrjsample [1] -> ntcpjsniffer; 

icmpen_catcher : : AdaptiveShaper(. 1,50); 

udp_split [1] -> [0] icmperr_catcher [0] -> tojrictim_js2; 

udp_f_split [1] -> [0] icmperr_catcher; 
45 icmperrjample [0] -> [1] icmperr_catcher [1] -> to_world; 
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#else 

udp_split [1] -> to_victim_s2; 
udp_f_split [1] -> to_victim_s2; 
5 icmp_unreach_co\inter [0] -> to_world; 

#endif 



10 = if.click 



// 

// input/output ethernet interface for router 
15 // 

// this configuration file leaves the following elements to be hooked up: 

II 

II from_victim: packets coming from victim 
// from_world: packets coming from world 
20 // to_world: packets going to world 

// to_victim_prio: high priority packets going to victim 

// to_victim_sl : best effort packets going to victim, tickets = 4 

// to_victim_s2: best effort packets going to victim, tickets = 1 

// 

25 // see bridge.click for a simple example of how to use this configuration. 

//victim network is 1.0.0.0/8 (ethl, 00:C0:95:E2:A8:A0) 
// world network is 2.0.0.0/8 (eth2, 00:CO:95:E2:A8:A1) and 
// 3.0.0.0/8 (eth3, 00:C0:95:E1:B5:38) 

30 

// ethernet input/output, forwarding, and arp machinery 

tol :: ToLinux; 
t :: Tee(6); 
35 t[5]->tol; 

arpql_prio :: ARPQuerier(l. 0.0.1, 00:C0:95:E2:A8:A0); 
arpql_sl :: ARPQuerier(l .0.0.1, 00:C0:95:E2:A8:A0); 
arpql_s2 :: ARPQuerier(1.0.0.1, 00:C0:95:E2:A8A0); 
40 arl :: ARPResponder(l. 0.0. 1/32 00:C0:95:E2:A8:A0); 
arpq2 :: ARPQuerier(2.0.0.1, 00:CO:95:E2A8:A1); 
ar2 :: ARPResponder(2.0.0.1/32 00:C0:95:E2:A8A1); 
arpq3 :: ARPQuerier(3.0.0.1, 00:C0:95:E1:B5:38); 
ar3 :: ARPResponder(3.0.0.1/32 00:C0:95:E1:B5:38); 

45 
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psched : : PrioSched; 
ssched :: StrideSched (4,1); 

outl_sl :: Queue(256) -> [0] ssched; 
5 outl js2 :: Queue(256) -> [1] ssched; 
outl_prio :: Queue(256) -> [0] psched; 
ssched -> [1] psched; 

psched[0] -> to_victim_counter :: Counter -> todevl :: ToDevice(ethl); 

1 0 out2 : : Queue(l 024) -> todev2 :: ToDevice(eth2); 
out3 :: Queue(1024) ~> todev3 :: ToDevice(eth3); 

to_victim_prio :: Counter -> tvpc :: Classifier(16/01, -); 
tvpc [0] -> [O]arpql_prio -> outl_prio; 
15 tvpc [l]-> Discard; 

to_victini_sl :: Counter -> tvslc :: Classifier(16/01, -); 
tyslc [0] -> [0]arpql_sl -> outljsl; 
tvslc [1] -> Discard; 

20 

to_victiin_s2 :: Counter -> tvs2c :: Classifier(16/01, -); 
tvs2c [0] -> [0]arpql_s2 -> outl_s2; 
tvs2c [1] -> Discard; 

25 to_world :: Counter -> twc :: Classifier(16/02, 16/03, -); 
twc [0] -> [0]arpq2 -> out2; 
twc [1] -> [0]arpq3 -> out3; 
twc [2] -> Discard; 

30 from_victim :: GetIPAddress(16); 
from_world :: GetIPAddress(16); 

indevl :: PollDevice(ethl); 
cl :: Classifier (12/0806 20/0001, 
35 12/080620/0002, 
12/0800, 

-); 

indevl -> from_victim_counter :: Counter -> cl; 

cl [0]->arl -> outljsl; 
40 cl[l]->t; 

cl [2] -> Strip(14) -> MarkBPHeader -> from_victim; 

cl [3] -> Discard; 

t[0] -> [1] arpql_prio; 

t[l]->[l]arpql_sl; 
45 t[2] -> [1] arpql_s2; 
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indev2 :: PollDevice(eth2); 
c2 :: Classifier (12/0806 20/0001, 
12/0806 20/0002, 
12/0800, 

5 -); 

indev2 -> from_attackers_connter :: Counter -> c2; 

c2 [0] -> ar2 -> out2; 

c2[l]->t; 

c2 [2] -> Strip(14) -> MarklPHeader -> from_world; 
10 c2 [3] -> Discard; 
t[3] -> [1] arpq2; 

indev3 :: PollDevice(eth3); 
c3 :: Classifier (12/0806 20/0001, 
15 12/0806 20/0002, 

12/0800, 

-); 

indev3->c3; 
c3 [0] -> ar3 -> out3; 
20 c3[l]->t; 

c3 [2] -> Strip(14) -> MarklPHeader -> from_world; 
c3 [3] -> Discard; 
t[4] -> [1] arpq3; 

25 ScheduleInfo(todevl 10, indevl 1, 
todev2 10, indev2 1, 
todev3 10, indev3 1); 



30 

== sampler.click 



elementclass RatedSampler { 
35 $rate | 

input -> s :: RatedSplitter($rate); 

s [0] -> [0] output; 

s [1] -> t :: Tee; 

t [0] -> [0] output; 
40 t [1] -> [1] output; 

}; 

elementclass ProbSampler { 
$prob| 

45 input -> s : : ProbSplitter($piob); 
s [0] -> [0] output; 
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s[l]->t::Tee; 
t [0] -> [0] output; 
t [1] -> [1] output; 

>; 

5 

= sniffer.click 



// setup a sniffer device, with a testing IP network address 
10 // 

// argument: name of the device to setup and send packet to 

elementclass Sniffer { 
$dev | 

15 FromLinux($dev, 192.0.2.0/24) -> Discard; 

input -> sniffer_ctr :: Counter 
-> ToLinuxSniffers($dev); 

}; 

20 

// note: ToLinuxSniffers take 2 us 
= synkill.click 



25 

// 

// SYNKill 

// 

// argument: true if monitor only, false if defend 
30 // 

// expects: input 0 - TCP packets with IP header to victim netwo± 
// input 1 - TCP packets with IP header to rest of internet 

// 

// action: protects against SYN flood by prematurely fimshing the three way 
35 // handshake protocol. 

// 

// outputs: output 0 - TCP packets to victim network 
// output 1 - TCP packets to rest of internet 
// output 2 - control packets (created by TCPSYNProxy) to victim 
40 // 

elementclass SYNKill { 
$monitor | 

// TCPSYNProxy(MAX_CONNS, THRESH, MNJTIMEOUT, MAX_TTMEOUT, 
45 PASSIVE); 

tcpsynproxy :: TCPSYNProxy(128, 4, 8, 80, $monitor); 
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input [0] -> [0] tcpsynproxy [0] -> [0] output; 
input [1] -> [1] tcpsynproxy [1] -> [1] output; 
tcpsynproxy [2] 
-> GetD?Address(16) 
5 -> [2] output; 

>; 

= ds.click 



10 

// 

// DetectSuspicious 

// 

// argument: takes in the victim network address and mask, for example: 
15 // DetectSuspicious(121A0400%FEFFFF00) 

// 

// expects: IP packets. 

// 

// action: detects packets with bad source addresses; 
20 // detects direct broadcast packets; 
// detects ICMP redirects. 

// 

// outputs: output 0 push out accepted packets, unmodified; 
// output 1 push out rejected packets, unmodified. 

25 // 

elementclass DetectSuspicious { 
$vnet | 

30 // see http://www.ietf.org/inte^ for a 

// list of bad source addresses to block out. we also block out packets with 
// broadcast dst addresses. 

bad_addr Jitter :: Classified 

35 12/$vnet, // port 0: victim network address 

12/00, // port 1: 0.0.0.0/8 (special purpose) 

12/7F, //port 2: 127.0.0.0/8 (loopback) 

12/OA, // port 3: 10.0.0.0/8 (private network) 

12/AC10%FFF0, // port 4: 172.16.0.0/12 (private network) 

40 12/C0A8, //port 5: 192.168.0.0/16 (private network) 

12/A9FE, //port 6: 169.254.0.0/16 (autoconf addr) 

12/C0000200%FFFEFFOO, // port 7: 192.0.2.0/24 (testing addr) 
12/E0%F0, // port 8: 224.0.0.0/4 (class D - multicast) 

12/F0%F0, // port 9: 240.0.0.0/4 (class E - reserved) 

45 12/00FFFFFF%00FFFFEF, // port 10: broadcast saddr X.255.255.255 
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12/O0OOFFFF%0OOOFFFF, //port 11: broadcast saddrX.Y.255. 255 
12/OOOO00FF%00O00OFF, // port 12: broadcast saddr X.Y.Z.255 
1 6/00FFFFFF%00FFFFFF, // port 13: broadcast daddr X255.255.255 
16/OOOOFFFF%0O0OFFFF, // port 14: broadcast daddr X.Y.255.255 
5 167000000FF%OOOOOOFF, // port 15: broadcast daddr X.Y.Z.255 
9/01, // port 16: ICMP packets 

-); 

input -> bad_addr_filter; 
10 bad_addr_filter [0] ->[1] output; 

bad_addr_filter [1] -> [1] output; 

bad_addr_filter [2] ->[1] output; 

bad_addr_filter [3] -> [1] output; 

bad_addr_filter [4] -> [1] output; 
15 bad_addr_filter [5] ->[1] output; 

bad_addr_filter [6] -> [1] output; 

bad_addr_filter [7] ->[1] output; 

bad_addr_filter [8] -> [1] output; 

bad_addr_filter [9] ->[1] output; 
20 badjiddr_fflter [10] -> [1] output; 

bad_addr_filter [11] -> [1] output; 

bad_addr_filter [12] -> [1] output; 

bad_addr_filter [13] -> [1] output; 

bad_addr_filter [14] -> [1] output; 
25 bad_addr_filter [15] -> [1] output; 

// ICMP rules: drop all fragmented and redirect ICMP packets 

bad_addr_filter [16] 
30 -> is_icmp_frag_packets : : Classifier(6/0000, -); 
is_icmp_frag_packets [1] -> [1] output; 

is_icmp_frag_packets [0] 
-> is_icmp_redirect :: IPClassifier(icmp type 5, -); 
35 is_icmp_redirect [0] -> [1] output; 

// finally, allow dynamic filtering of bad src addresses we discovered 
// elsewhere in our script 

40 dyn_saddr_filter :: AddrFilter(SRC, 32); 
is_icmp_redirect [1] -> dyn_saddr_filter; 
bad_addr_filter [17] -> dyn_saddr_filter; 
dyn_saddr_filter [0] -> [0] output; 
dyn_saddr_filter [1] -> [1] output; 

45 

}; 
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// 

5 //TCPTrafficMonitor 

// 

// expects: input 0 takes TCP packets w IP header for the victim network; 
// input 1 takes TCP packets w IP Header from the victim network, 
//action: monitors packets passing by 
10 // outputs: output 0 - packets for victim network, unmodified; 
// output 1 - packets from victim network, unmodified. 
// 

elementclass TCPTrafficMonitor { 
15 // fwd annotation = rate of src_addr, rev annotation = rate of dst_addr 
tcp_rm :: IPRateMonitor(PACKETS, 0, 1, 100, 4096, true); 

// monitor all TCP traffic to victim, monitor non-RST packets from victim 
input [0] -> [0] tcp_rm [0] -> [0] output; 
20 input [1] -> il_tcp_rst :: PClassifiei<rst, -); 
il _tcp_rst[0] -> [1] output; 
il _tcp_rst[l] -> [1] tcp_rm [1] -> [1] output; 

}; 

25 



30 20094505.doc 
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Appendix listing of additional Click modules ("elements"). 
ADAPTI VESHAPER ( n ) ADAPTI VESHAPER { n ) 

5 

NAME 

Adaptive Shape r - Click element 
SYNOPSIS 

10 AdaptiveShaper<DROP_P, REPRESSJfEIGHT) 

PROCESSING TYPE 
Push 

15 DESCRIPTION 

Adapt iveShaper is a push element that shapes input traffic 
from input port 0 to output port 0. Packets are shaped 
based on "repressive" traffic from input port 1 to output 
port 1. Each repressive packet increases a multiplicative 

20 factor f by REPRESS_WEIGHT. Each input packet is killed 

instead of pushed out with f * DR0P_P probability. After 
each dropped packet, f is decremented by 1. 



25 EXAMPLES 

ELEMENT HANDLERS 

drop_prob (read/write) 
value of DROP_P 

30 

repress_weight (read/write) 
value of REPRESS_WEIGHT 

35 



SEE ALSO 

40 PacketShaper (n) , RatioShaper (n) 



45 



50 



55 
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ADAPTIVESPLITTER (n) 



NAME 

5 Adapt iveSplitter - Click element 

SYNOPSIS 

AdaptiveSplitter (RATE) 

10 PROCESSING TYPE 
Push 

DESCRIPTION 

AdaptiveSplitter attempts to split RATE number of packets 
15 per second for each address. It takes the fwd_rate annota- 

tion set by IPRateMonitor (n) , and calculates a split prob- 
ability based on that rate. The split probability attempts 
to guarantee RATE number of packets per second. That is, 
the lower the fwd_rate, the higher the split probability. 

20 

Splitted packets are on output port 1. Other packets are 
on output port 0. 

25 EXAMPLES 

AdaptiveSplitter (10) ; 



30 

SEE ALSO 

IPRateMonitor (n) 



35 



40 



45 



50 
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ADDRFILTER(n) ADDRFILTER (n) 



NAME 

5 AddrFilter - Click element 

SYNOPSIS 

AddrFilter (DST/SRC, N) 

10 PROCESSING TYPE 
Push 

DESCRIPTION 

Filters out IP addresses given in write handler. DST/SRC 
15 specifies which IP address (dst or src) to filter. N is 

the maximum number of IP addresses to filter at any time. 
Packets passed the filter goes to output 0. Packets 
rejected by the filter goes to output 1. 

20 AddrFilter looks at addresses in the IP header of the 

packet, not the annotation. It requires an IP header anno- 
tation ( MarklPHeader (n) ) . 



25 EXAMPLES 

AddrFilter (DST, 8) 
.Filters by dst IP address, up to 8 addresses. 

30 

ELEMENT HANDLERS 

table ((read)) 

Dumps the list of addresses to filter and 

35 



add ( (write) ) 

Expects a string "addr mask duration", where addr is 
40 an IP address, mask is a netmask, and duration is the 

number of seconds to filter packets from this IP 
address. If 0 is given as a duration, filtering is 
removed. For example, "18.26.4.0 255.255.255.0 10" 
would filter out all packets with dst or source 
45 address 18.26.4.* for 10 seconds. New addresses push 

out old addresses if more than N number of filters 
already exist. 



50 

reset ( (write) ) 

Resets on write. 



55 SEE ALSO 

Classifier (n) , MarklPHeader (n) 
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NAME 

5 AttackLog - Click element; maintains a log of attack pack- 

ets in SAVE_FILE. 

SYNOPSIS 

AttackLog (SAVE_FILE, INDEX_FILE, MULTIPLIER, PERIOD) 

10 

PROCESSING TYPE 
Agnostic 

DESCRIPTION 

15 Maintains a log of attack packets in SAVE_FILE. Expects 

packets with ethernet headers, but with the first byte of 
the ethernet header replaced by an attack bitmap, set in 
kernel. AttackLog classifies each packet by the type of 
attack, and maintains an attack rate for each type "of 

20 attack. The attack rate is the arrival rate of attack 

packets multiplied by MULTIPLIER. 

AttackLog writes a block of data into SAVE_FILE once every 
PERIOD number of seconds. Each block is composed of 
25 entries of the following format: 

delimiter (Os) 4 bytes 

time 4 bytes 

attack type 2 bytes 

30 attack rate 4 bytes 

ip header and payload (padded) 86 bytes 

100 bytes 

35 .Entries with the same attack type are written out 

together. A delimiter of OxFFFFFFFF is written to the end 
of each block. 

A circular timed index file is kept in INDEX_FILE along 
40 side the attacklog. See Circularlndex (n) . 



SEE ALSO 
45 Circularlndex (n) 
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FILTERTCP (n) FILTERTCP (n) 



NAME 

5 FilterTCP - Click element 

SYNOPSIS 

FilterTCP ( ) 

10 PROCESSING TYPE 
Push 



DESCRIPTION 

Expects TCP/IP packets as input. 

15 
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DISCARDTODEVICE (n) DISCARDTODEVICE <n) 



NAME 

5 DiscardToDevice - Click element; drops all packets, gives 

skbs to device. 

SYNOPSIS 

DiscardToDevice (DEVICE) 

10 

PROCESSING TYPE 
Agnostic 

DESCRIPTION 

15 Discards all packets received on its single input. Gives 

all skbuffs to specified device. 



20 
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FROMTUNNEL { n ) FROMTUNNEL { n ) 



NAME 

5 FromTunnel - Click element 

SYNOPSIS 

FromTunnel (TUNNEL, SIZE, BURST) 

10 PROCESSING TYPE 
Push 

DESCRIPTION 

Grab packets from kernel KUTunnel element. TUNNEL is a 
15 /proc file in the handler directory of the KUTunnel ele- 

ment. SIZE specifies size of the buffer to use (if packet 
in kernel has larger size, it is dropped) . BURST specifies 
the maximum number of packets to push each time FromTunnel 
runs . 

20 

EXAMPLES 

FromTunnel ( /proc/click/tunnel/conf ig) 

25 
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ICMPPINGENCAP (n) ICMPPINGENCAP (n) 



NAME 

5 ICMPPINGEncap - Click element 

SYNOPSIS 

ICMPPINGEncap (SADDR, DADDR [, CHECKSUM?]) 

10 DESCRIPTION 

Encapsulates each incoming packet in a ICMP ECHO/ IP packet 
with source address SADDR and destination address DADDR. 
The ICMP and IP checksums are calculated if CHECKSUM? is 
true; it is true by default. 

15 

EXAMPLES 

ICMPPINGEncap (1.0. 0.1, 2.0.0.2) 

20 
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GATHERRATES (n) GATHERRATES (n) 



NAME 

5 GatherRates - Click element 

SYNOPSIS 

GatherRates (SAVE_FILE, INDEX_FILE, TCPMONITORJCN, TCPMONI- 
TOR_OUT, MONITOR_PERIOD, SAVE_PERIOD) ; 

10 

PROCESSING TYPE 
Agnostic 

DESCRIPTION 

15 Gathers aggregate traffic rates from TCPMonitor (n) element 

at TCPMONITOR_IN and TCPMONITOR_OUT . 

Aggregate rates are gathered once every MONITOR_PERIOD 
number of seconds. They are averaged and saved to 
20 SAVE_FILE once every SAVE_PERIOD number of seconds. The 

following entry is written to SAVE_FILE for both incoming 
and outgoing traffic: 

delimiter (0s) 4 bytes 

25 time 4 bytes 
type (0 for incoming traffic, 1 for outgoing traffic) 4 bytes 

packet rate of tcp traffic 4 bytes 

byte rate of tcp traffic 4 bytes 

rate of fragmented tcp packets 4 bytes 

30 rate of tcp syn packets 4 bytes 

rate of tcp fin packets 4 bytes 

rate of tcp ack packets 4 bytes 

rate of tcp rst packets 4 bytes 

rate of tcp psh packets 4 bytes 

35 rate of tcp urg packets 4 bytes 

packet rate of non-tcp traffic 4 bytes 

byte rate of non-tcp traffic 4 bytes 

rate of fragmented non-tcp traffic 4 bytes 

rate of udp packets 4 bytes 

40 rate of icmp packets 4 bytes 

rate of all other packets 4 bytes 



45 



72 bytes 



After the two entries, an additional delimiter of 
OxFFFFFFFF is written. SAVEJPERIOD must be a multiple of 
MONITOR PERIOD, 



50 A circular timed index is kept along side the stats file. 

See Circularlndex(n) . 



55 SEE ALSO 

TCPMonitor (n) Circularlndex (n) 
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KUTUNNEL (n) 



NAME 

5 KUTunnel - Click element; stores packets in a FIFO queue 

that userlevel Click elements pull from. 

SYNOPSIS 

KUTunnel ( [CAPACITY] ) 

10 

PROCESSING TYPE 
Push 

DESCRIPTION 

15 Stores incoming packets in a first-in-first-out queue. 

Drops incoming packets if the queue already holds CAPACITY 
packets. The default for CAPACITY is 1000. Allows user- 
level elements to pull from queue via ioctl. 

20 

ELEMENT HANDLERS 

length (read-only) 

Returns the current number of packets in the queue. 

25 

highwater_length (read-only) 

Returns the maximum number of packets that have ever 
been in the queue at once. 

30 



capacity (read/write ) 

Returns or sets the queue's capacity. 

35 



drops (read-only) 

Returns the number of packets dropped so far. 

40 



45 SEE ALSO 

Queue (n) 
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LOGGER ( n ) LOGGER ( n ) 



NAME 

5 Logger - Click element 

SYNOPSIS 

Logger (LOGFILE, INDEX FILE [, LOCKFILE, COMPRESS?, LOGSIZE, 
PACKETSIZE, WRITEPERIOD, IDXCOALESC, PACKET FREQ, MAXBUF- 
10 SIZE ] ) 

PROCESSING TYPE 
Agnostic 

15 DESCRIPTION 

Has one input and one output. 

Write packets to log file LOGFILE. A log file is a circu- 
lar buffer containing packet records of the following 
20 form: 



I time (6 bytes) I 
| length (2 bytes) | 
25 I packet data I 



Time is the number of seconds and milliseconds since the 
Epoch at which a given packet was seen. Length is the 
30 length (in bytes) of the subsequent logged packet data. 

One or more packet records constitute one packet sequence. 

INDEXFILE maintains control data for LOGFILE. It contains 
a sequence of sequence control blocks of the following 
35 form: 



| date (4 bytes) | 
I offset (sizeof off_t) I 
40 I length (sizeof off J:) | 



Date is a number of seconds since the Epoch. Offset 
points to the beginning of the packet sequence, i.e. to 
45 the earliest packet record having a time no earlier than 

date. Length is the number of bytes in the packet 
sequence. IDXCOALESC is the number of coalescing packets 
that a control block always cover. Default is 1024. 

50 Sequence control blocks are always stored in increasing 

chronological order; offsets need not be in increasing 
order, since LOGFILE is a circular buffer. 

COMPRESS? (true, false) determines whether packet data is 
55 logged in compressed form. Default is true. 
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. LOGSIZE specifies the maximum allowable log file size, in 
KB, Default is 2GB. LOGSIZE=0 means "grow as necessary". 

PACKETSIZE is the amount of packet data stored in the log. 
5 By default, the first 120 (128-6-2) bytes are logged and 

the remainder is discarded. Note that PACKETSIZE is the 
amount of data logged before compression. 

Packet records are buffered in memory and periodically 
written to LOG FILE as a packet sequence. WRITEPERIOD is 
the number of seconds that should elapse between writes to 
LOGFILE. Default is 60. INDEXFILE is updated every time a 
sequence of buffered packet records is written to LOGFILE. 
The date in the sequence control block is the time of the 
first packet record of the sequence, with milliseconds 
omitted. 

PACKET FREQ is an estimate of the number of packets per 
second that will be passing through Logger. Combined with 
WRITEPERIOD, this is a hint of buffer memory requirements. 
By default, PACKET FREQ is 1000. Since by default WRITEPE- 
RIOD is 60 and each packet record is at most 128 bytes, 
Logger normally allocates 7500KB of memory for the buffer. 
Logger x will grow the memory buffer as needed up to a maxi- 
mum of MAXBUFSIZE KB, at which point the buffered packet 
records are written to disk even if WRITEPERIOD seconds 
have not elapsed since the last write. Default MAXBUFSIZE 
is 65536 (64MB) . 

30 



10 



15 



20 



25 
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MONITORSRC16 (n) MONITORSRC16 (n) 



NAME 

5 MonitorSRC16 - Click element 

SYNOPSIS 

MonitorSRC16 (SAVE_FILE, INDEX_FILE, MULTIPLIER, PERIOD, 
WRAP) 

10 

PROCESSING TYPE 
Agnostic 

DESCRIPTION 

15 Examines src address of packets passing by. Collects 

statistics for each 16 bit IP address prefix. The follow- 
ing data structure is written to SAVE_FILE for every 16 
bit IP address prefix every PERIOD number of seconds. 



20 


delimiter (Os) 


{4 


bytes) 




time 


(4 


bytes) 




addr 


(4 


bytes) 




top rate 


(4 


bytes) 




non tcp rate 


(4 


bytes) 


25 


percent of tcp 


(1 


byte) 




percent of tcp frag 


(1 


byte) 




percent of tcp syn 


(1 


byte) 




percent of tcp fin 


(1 


byte) 




percent of tcp ack 


(1 


byte) 


30 


percent of tcp rst 


(1 


byte) 




percent of tcp psh 


(1 


byte) 




. percent of tcp urg 


(1 


byte) 




percent of non tcp frag 


(1 


byte) 




percent of udp 


(1 


byte) 


35 


percent of icmp 


(1 


byte) 




reserved 


(1 


byte) 






32 


bytes 



40 TCP and non TCP rates are multiplied by MULTIPLIER. An 

additional delimiter of OxFFFFFFFF is written at the end 
of a block of entries. 

WARP specifies the number of writes before wrap-around. 
45 For example, if PERIOD is 60, WARP is 5, then every 5 min- 

utes, the stats file wrap around. 

A timed circular index is maintained along side the 
statistics file in INDEX_FILE. See Circularlndex (n) . 

50 



SEE ALSO 

Circularlndex (n) 

55 
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RANDOMTCPIPENCAP (n) RANDOMTCPIPENCAP (n) 



NAME 

5 RandomTCPIPEncap - Click element 

SYNOPSIS 

RandomTCPIPEncap (DA BITS [DP SEQN ACKN CHECKSUM SA MASK] ) 

10 PROCESSING TYPE 
Agnostic 

DESCRIPTION 

Encapsulates each incoming packet in a TCP/IP packet with 
15 random source address and source port, destination address 

DA, and control bits BITS. If BITS is -1, control bits 
are also generated randomly. If destination port DP, 
sequence number SEQN, or ack number ACKN is specified and 
non-zero, it is used. Otherwise, it is generated randomly 
20 for each packet. IP and TCP checksums are calculated if 

CHECKSUM is true; it is true by default. SEQN and ACKN 
should be in host order. SA and MASK are optional IP 
address; if they are specified, the source address is com- 
puted as {(random() & MASK) I SA) . 

25 

EXAMPLES 

RandomTCPIPEncap (1.0. 0.2 4) 

30 



SEE ALSO 

RoundRobinTCPIPEncap(n) , RandomUDPIPEncap(n) 

35 
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RANDOMUDPIPENCAP (n) RANDOMUDPIPENCAP (n) 



NAME 

RandomUDPIPEncap - Click element 
SYNOPSIS 

RandomUDPIPEncap (SADDR SPORT DADDR DPORT PROB [CHECKSUM?] 
[/ ...]) 

PROCESSING TYPE 
Agnostic 



DESCRIPTION 

15 Encapsulates each incoming packet in a UDP/IP packet with 

source address SADDR, source port SPORT, destination 
address DADDR, and destination port DPORT . The UDP check- 
sum is calculated if CHECKSUM? is true; it is true by 
default. / 



PROB gives the relative chance of this argument be used 
over others . 



The RandomUDPIPEncap element adds both a UDP header and an 
25 IP header. 

You can a maximum of 16 arguments- Each argument specifies 
a single UDP/IP header. The element will randomly pick one 
argument. The relative probabilities are determined by 
30 PROB. 

The Strip (n) element can be used by the receiver to get 
rid of the encapsulation header. 

35 EXAMPLES 

RandomUDPIPEncap (1.0. 0.1 1234 2.0.0.2 1234 1 1, 

1.0.0.2 1093 2.0.0.2 1234 2 1) 

Will send about twice as much UDP/IP packets with 1.0.0.2 
40 as its source address than packets with 1.0.0.1 as its 

source address. 



45 SEE ALSO 

Strip(n), UDPIPEncap(n) , RoundRobinUDPIPEncap (n) 
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RATEWARN (n) RATEWARN(n) 



NAME • 

5 RateWarn - Click element; classifies traffic and sends out 

warnings when rate of traffic exceeds specified rate. 

SYNOPSIS 

RateWam(RATE, WARNFREQ) 

10 

PROCESSING TYPE 
Push 

DESCRIPTION 

15 RateWarn has three output ports. It monitors the rate of 

packet arrival on input port 0. Packets are forwarded to 
output port 0 if rate is below RATE. If rate exceeds 
RATE, it sends out a warning packet WARNFREQ number of 
seconds apart on output port 2 in addition to forwarding 

20 all traffic through output port 1. 



SEE ALSO 

PacketMeter (n) 

25 
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RATIOSHAPER (n) RATIOSHAPER (n) 



NAME 

5 RatioShaper - Click element 

SYNOPSIS 

RatioShaper (FWD_WEIGHT, REVJtfEIGHT, THRESH, P) 

10 PROCESSING TYPE 
Push 

DESCRIPTION 

RatioShaper shapes packets based on fwd_rate_anno and 
15 rev_rate_anno rate annotations set by IPRateMonitor (n) . 

If either annotation is greater than THRESH, and 
FWD_WEIGHT*fwd_rate_anno > REV_WEIGHT*rev_rate_anno, the 
packet is moved onto output port 1 with a probability of 

20 mind, 

P* (fwd_rate_anno*FWD_WEIGHT) / (rev_rate_anno*REV_WEIGHT) } 

FWD_WEIGHT, REV_ WEIGHT, and THRESH are integers. P is a 
decimal between 0 and 1. Otherwise, packet is forwarded on 
25 output port 0. 



EXAMPLES 

30 RatioShaper (1, 2, 100, .2); 

if fwd_rate_anno more than twice as big as rev_rate_anno, 
and both rates are above 100, drop packets with an initial 
probability of 20 percent. 

35 



ELEMENT HANDLERS 

fwd_weight (read/write) 
40 value of FWD_WEIGHT 



rev_weight (read/write) 
value of REV_WEIGHT 

45 

thresh ( r ead/ wri t e ) 
value of THRESH 

50 

dropjprob (read/write) 
value of P 



55 

SEE ALSO 

Block (n) , IPRateMonitor (n) 
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REPORTACTIVITY (n) REPORTACTIVITY (n) 



NAME 

5 ReportActivity - Click element 

SYNOPSIS 

ReportActivity (SAVEJiTLE, IDLE) 

10 PROCESSING TYPE 
Agnostic 

DESCRIPTION 

Write into SAVE_FILE a 32 bit time value followed by an 
15 ASCII representation of that time stamp whenever a packet 

comes by. If IDLE number of seconds pass by w/o a packet, 
removes the file. 

20 
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ROCJNDROB I NS ET I PADDRES S (n) ROUNDROBINSETIPADDRESS (n) 



NAME 

5 RoundRobinSetXPAddress - Click element 

SYNOPSIS 

RoundRobinSetlPAddress (ADDR [ , . . . ] ) 

10 PROCESSING TYPE 
Agnostic 

DESCRIPTION 

Set the destination IP address annotation of each packet 
15 with an address chosen from the configuration string in 

round robin fashion. Does not compute checksum (use 
SetlPChecksum(n) or . SetUDPTCPChecksum (n) ) or encapsulate 
the packet with headers (use RoundRobinUDPIPEncap(n) or 
RoundRobinTCPIPEncap(n) with bogus address). 

20 

EXAMPLES 

RoundRobinDDPIPEncap(2.0.0.2 0.0,0.0 0 0 0) 

-> RoundRobinSetlPAddress (1.0. 0.2, 1.0.0.3, 1.0.0.4) 
25 -> StoreIPAddress(12) 

-> SetlPChecksum 
-> SetUDPTCPChecksum 

this configuration segment places an UDP header onto each 
30 packet, with randomly generated source and destination 

ports. The destination IP address is 2.0.0.2, the source 
IP address is 1.0.0.2, or 1.0.0.3, or 1.0.0.4. Both IP and 
UDP checksum are computed. 

35 

SEE ALSO 

RoundRobinUDPIPEncap(n) , RoundRobinTCPIPEncap(n) , UDPIPEn- 
cap(n) , SetlPChecksum (n) , SetUDPTCPChecksum (n) , SetlPAd- 
40 dress (n), Store IPAddress (n) 
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ROUNDROBINTCPIPENCAP (n) ROUNDROBINTCPIPENCAP (n) 



NAME 

5 RoundRobinTCPIPEncap - Click element 

SYNOPSIS 

RoundRobinTCPIPEncap (SA DA BITS [SP DP SEQN ACKN CHECKSUM] 
[/ -..]) 

10 

PROCESSING TYPE 
Agnostic 

DESCRIPTION 

15 Encapsulates each incoming packet in a TCP/IP packet with 

source address SA, source port SP (if 0, a random one is 
generated for each packet), destination address DA, and 
destination port DP (if 0, a random one is generated for 
each packet), and control bits BITS, If SEQN and ACKN 

20 specified are non-zero, they are used. Otherwise, they 

are randomly generated for each packet. IP and TCP check- 
sums are calculated if CHECKSUM is true; it is true by 
default. SEQN and ACKN should be in host order. 

25 The RoundRobinTCPIPEncap element adds both a TCP header 

and an IP header. 

You can give as many arguments as you'd like. Each argu- 
ment specifies a single TCP/IP header. The element will 
30 cycle through the headers in round-robin order. 

The Strip (n) element can be. used by the receiver to get 
rid of the encapsulation header. 

35 EXAMPLES 

RoundRobinTCPIPEncap (2. 0.0.2 1.0.0.2 4 1022 1234 423874 92* 
2394839 1, 

2.0.0.2 1.0.0.2 2) 

40 



SEE ALSO 

Strip (n) , RoundRobinUDPIPEncap (n) 

45 
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ROUNDROBINUDPIPENCAP (n) 



ROUNDROBINUDPIPENCAP (n) 



NAME 



5 



RoundRobinUDPIPEncap - Click element 



SYNOPSIS 



RoundRobinUDPIPEncap (SADDR DADDR [SPORT DPORT CHECKSUM?] 
[, ...]) 



PROCESSING TYPE 
Agnostic 

DESCRIPTION 

15 Encapsulates each incoming packet in a DDP/IP packet with 

source address SADDR, source port SPORT, destination 
address DADDR, and destination port DPORT. The UDP and IP 
checksums are calculated if CHECKSUM? is true; it is true 
by default. If either DPORT or SPORT is 0, the port will 

20 be randomly generated for each packet. 



The RoundRobinUDPIPEncap element adds both a UDP header 
and an IP header. 

You can give as many arguments as you'd like. Each argu- 
ment specifies a single UDP/IP header. The element will 
cycle through the headers in round-robin order. 

The Strip (n) element can be used by the receiver to get 



10 



30 



rid of the encapsulation header. 



EXAMPLES 



RoundRobinUDPIPEncap(2.0.0.2 1.0.0.2 1234 1002 1, 

2.0.0.2 1.0.0.2 1234) 



35 



SEE ALSO 



40 



Strip (n) , UDPIPEncap (n) 
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SETSNIFFFLAGS (n) SETSNIFFFLAGS (n) 



NAME 

5 SetSniff Flags - Click element; sets sniff flags annota- 

tion. 

SYNOPSIS 

Set Sniff Flags (FLAGS [, CLEAR] ) 

10 

PROCESSING TYPE 
Agnostic 

DESCRIPTION 

15 Set the sniff flags annotation of incoming packets to 

FLAGS bitwise or with the old flags, if CLEAR is true 
(false by default), the old flags are ignored. 



20 
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SETUDPTCPCHECKSUM (n) SETUDPTCPCHECKSUM (n) 



NAME 

5 SetUDPTCPChecksum - Click element 

SYNOPSIS 

SetUDPTCPChecksum ( ) 

10 PROCESSING TYPE 
Agnostic 

DESCRIPTION 

Expects an IP packet as input. Calculates the ICMP, UDP or 
15 TCP header's checksum and sets the checksum header field. 

Does not modify packet if it is not an ICMP, UDP, or TCP 
packet . 

20 SEE ALSO 

SetlPChecksum(n) 
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S TORESNI FFFLAGS (n) STORESNIFFFLAGS (n) 



NAME 

5 StoreSniff Flags - Click element; stores sniff flags anno- 

tation in packet 

SYNOPSIS 

StoreSniff Flags (OFFSET) 

10 

PROCESSING TYPE 
Agnostic 

DESCRIPTION 

15 Copy the sniff flags annotation into the packet at offset 

OFFSET . 
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TCPMONITOR (n) TCPMONITOR (n) 



NAME 

5 TCPMonitor - Click element 

SYNOPSIS 

TCPMonitor () 

10 PROCESSING TYPE 
Push 

DESCRIPTION 

Monitors and splits TCP traffic. Output 0 are TCP traffic, 
15 output 1 are non-TCP traffic. Keeps rates of TCP, TCP 

BYTE, SYN, ACK, PUSH, RST, FIN, URG, and fragmented pack- 
ets. Also keeps rates of ICMP, UDP, non-TCP BYTE, and non- 
TCP fragmented traffic. 

20 

ELEMENT HANDLERS 

rates (read) 

dumps rates 

25 
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TCPSYNPROXY (n) TCPSYNPROXY (n) 



NAME 

5 TCPSYNProxy - Click element 

SYNOPSIS 

TCPSYNProxy (MAX_CONNS , THRESHOLD, MINJTIMEOUT, MAXJTIMEOUT 
[, PASSIVE] ) 

10 

PROCESSING TYPE 
Push 

DESCRIPTION 

Help settup a three way TCP handshake from A to B by sup- 
plying the last ACK packet to the SYN ACK B sent prema- 
turely, and send RST packets to B later if no ACK was 
received from A. 

Expects IP encapsulated TCP packets, each with its ip 
header marked ( MarklPHeader (n) or ChecklPHeader (n) ) . 

Aside from responding to SYN ACK packets from B, TCPSYN- 
Proxy also examines SYN packets from A. When a SYN packet 
25 from A is received, if there are more than MAX_CONNS num- 

ber of outstanding 3 way connections per destination 
(daddr + dport), reject the SYN packet. If MAX_CONNS is 0, 
no maximum is set. 

The duration from sending an ACK packet to B to sending a 
RST packet to B decreases exponentially as the number of 
outstanding connections to B increases pass 2 A THRESHOLD. 
The minimum timeout is MINJTIMEOUT. If the number of out- 
standing half-open connections is above 2 yv THRESHOLD, the 
timeout is 

max (MINJTIMEOUT, MAXJTIMEOUT » (N » THRESHOLD) ) 

Where N is the number of outstanding half-open connec- 
tions. For example, let the MINJTIMEOUT value be 4 sec- 
onds, the MAXJTIMEOUT value be 90 seconds, and THRESHOLD 
be 3. Then when N < 8, timeout is 90. When N < 16, timeout 
is 45. When N < 24, timeout is 22 seconds. When N < 32, 
timeout is 11 seconds. When N < 64, timeout is 4 seconds. 
Timeout period does not decrement if the threshold is 0. 

TCPSYNProxy has two inputs, three outputs. All inputs and 
outputs take in and spew out packets with IP header. 
Input 0 expects TCP packets from A to B. Input 1 expects 
TCP packets from B to A. Output 0 spews out packets from A 
to B. Output 1 spews out packets from B to A. Output 2 
spews out the ACK and RST packets generated by the ele- 
ment . 

55 If PASSIVE is true (it is not by default), monitor TCP 

three-way handshake instead of actively setting it up. In 
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this case, no ACK or RST packets will be sent. When an 
outstanding SYN times out, the SYN ACK packet is sent out 
of output port 2. No packets on port 0 are modified or 
dropped in this operating mode. 



EXAMPLES 

... -> ChecklPHeaderO -> TCPSYNProxy (128, 3, 10, 90) -> 

10 



ELEMENT HANDLERS 
15 summary (read) 

Returns number of ACK and RST packets sent and number 
of SYN packets rejected. 



20 

table (read) 

Dumps the table of half-opened connections. 



25 

reset (write) 

Resets on write. 



30 



SEE ALSO 

MarklPHeader (n) , ChecklPHeader (n) 

35 
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TCPSYNRESP (n) 



NAME 

5 TCPSYNResp - Click element 

SYNOPSIS 

TCPSYNResp {) 

10 PROCESSING TYPE 
Push 

DESCRIPTION 

Takes in TCP packet, if it is a SYN packet, return a SYN 
15 ACK. This is solely for debugging and performance tunning 

purposes. No checksum is done. Spews out original packet 
on output 0 untouched. Spews out new packet on output 1. 



20 



25 

201094509.doc 
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What is claimed is: 

1. A data collector comprises: 

a device to sample packet traffic, accumulate, and 
collect statistical information about network flow; and 
5 a port to link the data collectors over a redundant 

network to a central control center. 

2. A data collector to sample packet traffic, 
accumulate, and collect statistical information about 

10 network flows comprises: 

a computing device that executes a computer program 
product stored on a computer readable medium comprising 
instructions to cause the computing device to: 

perform sampling and statistic collection of 
15 data pertaining to network packets; and 

parse the information in the sampled packets and 
maintain the information in a log; and 
a port to link the data collectors over a redundant 
network to a central control center. 

20 

3. The data collector of claim 2 wherein the link is a 
link to a hardened, redundant network. 

4 . The data collector of claim 3 wherein the hardened 
25 redundant network is a telephone network or dedicated 

leased line. 

5. The data collector of claim 2 wherein information 
collected by the data collector includes source 

30 information and destination information. 
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6. The data collector of claim 5 wherein the data 
collector collects the information but does not log the 
sampled packets. 

5 7. The data collector of claim 2 wherein the computer 
program product in the data collector executes rules to 
analyze the collected statistics and may if necessary 
compose a message that raises an alarm to the control 
center. 

10 

8. The data collector of claim 2 wherein the data 
collector further includes a communication process to 
respond to queries concerning characteristics of traffic 
on the network. 

15 

9. The data collector of claim 8 wherein the queries 
originate from the control center and are for information 
pertaining to statistics collected by the data collector. 

20 10. The data collector of claim 1 wherein the query can 
be a request to download via the hardened network, a 
portion of the contents of the log. 

11. A method of collecting data from sampled network 
25 traffic, pertaining to network traffic flows comprises: 

sampling the network traffic and generating 
statistics pertaining to the sampled network packets; and 

communicating the generated statistics over a 
redundant network to a central control center. 

30 

12. The method of claim 11 wherein generating further 
comprises : 
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monitoring a parameter of traffic flow at multiple 
levels of granularity. 

13. The method of claim 12 wherein monitoring the 

5 parameter at multiple levels of granularity is used to 
to trace the source of an attack. 

14. The method of claim 13 wherein monitoring further 
comprises : 

10 dividing the traffic flow into buckets that track 

counts of how many packets a data collector or gateway 

examines for a given parameter; and 

adjusting the number of buckets as the number of 

buckets approaches a bucket threshold, by combining 
15 several buckets into fewer buckets or dividing a bucket 

into more buckets. 

15. The method of claim 11 wherein generating further 
comprises: 

20 applying multi-level analysis to monitor TCP packet 

ratios, repressor traffic and statistics based on Layer 3- 
7 analysis. 

16. The method of claim 15 wherein layer 3-7 analysis 
25 comprises: 

monitoring network traffic for unusual levels of IP 
fragmentation, or fragmented IP packets with bad or 
overlapping fragment offsets. 

30 17. The method of claim 15 wherein layer 3-7 analysis 
comprises: 
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monitoring network traffic for IP packets with 
obviously bad source addresses or ICMP packets with 
broadcast destination addresses. 

18. The method of claim 15 wherein layer 3-7 analysis 
comprises : 

monitoring network traffic for transport control 
protocol (TCP) or user datagram protocol (UDP) packets 
addressed to unused ports. 

19. The method of claim 15 wherein layer 3-7 analysis 
comprises: 

monitoring network traffic for transmission control 
protocol (TCP) packets with unusually small window sizes, 
which can indicate server load, or transmission control 
protocol (TCP) ACK packets that do not belong to a known 
connection. 

20. The method of claim 15 wherein layer 3-7 analysis 
20 comprises: 

monitoring network traffic for an indication of a 
frequency of reload requests that are sustained at a rate 
higher than plausible for a human user over a persistent 
HTTP connection. 

21. A computer program product residing on a computer 
readable medium for controlling a data collector to sample 
packet traffic, accumulate, and collect statistical 
information about network flows comprises instructions for 

30 causing the data collector to: 

perform sampling and statistic collection of data 
pertaining to network packets; 



10 
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parse the information in the sampled packets and 
maintain the information in a log; and 

communicate statistics generated by the data 
collector to a central control center over a redundant 
5 network. 
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44, collect and log source info. 
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destination info. 
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50, Analyze collected source and 
destination info. 
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33b, Repressor Traffic Process 




f 


33c, TCP Handshake Analysis 



Analysis 

process 

32b 



33d, Layer 3-7 analysis 



33e, Logging and Historical 
analysis 



j 



FIG. 6 



WO 02/21302 PCT/US01/27402 

8/10 




WO 02/21302 



9/10 



PCT/US01/27402 



Obtain ratio of packets 
In/Out, 82 



threshold 



Compare packet ratio to 
threshold, 84 



<;2 



32 



FIG. 9 



>2 



Store and stamp, 86 



Analysis, 88 




Raise alarm to 
Control Center, 90 



WO 02/21302 



10/10 



PCT/US01/27402 



Forward SYN Packet 
from client, 102 




f 


Forward SYN ACK Packet 
from server to client, 104 




r 


Gateway 26 immediately 
sends ACK to client, 1 06 




r 


Time out period expires, 108 




r 


DID ACK arrive from 
client? 110 




no 




r 


Count, 111 


i 




Send reset to close 
connection, 112 




_yes_ 



Forward ACK, 114 



Normal traffic exit, 1 16 




FIG. 10 



INTERNATIONAL SEARCH REPORT 



International application No. 
PCT/US01/27402 



A. CLASSIFICATION OF SUBJECT MATTER 
IPC(7) : G06F 15/76, 11/30 
US CL : 370/252, 389; 709/223, 224; 713/200 
According to International Patent aassification (IPC) or to both nat ional classification and IPC 



B. FIELDS SEARCHED 



Minimum documentation searched (classification system followed by classification symbols) 
U.S. : 370/252, 389, 229, 352, 469; 709/223, 224; 713/200; 379/106.01, 106.03 



Documentation searched other than minimum documentation to the extent that such documents are included in the fields searched 



Electronic data base consulted during the international search (name of data base and, where practicable, search terms used) 
EAST, WEST, DERWENT, IEEE 



C. DOCUMENTS CONSIDERED TO BE RELEVANT 



Category 3 



Y 

Y,B 



Citation of document, with indication, where appropriate, of the relevant passages 



US 5,231,593 A (NOTESS) 27 July 1993, col. 3, lines 1-25, col. 4, lines 11-23, 57-64, 
col. 5, lines 14-67, col. 7, lines 40-47, col. 8, lines 25-35, col. 9, lines 30-22. 
US 6 321,263 Bl (LUZZI et al. ) 20 November 2001, col. 3, lines 10-36, col. 5, lines 
24-38, col. 6, 19-54, col. 12, lines 16-27, col. 16, lines 35-54. col. 17, lines 4046, col. 
22, lines 7-16, col. 23, lines 30-49, col. 24, lines 48-56, col. 26, lines 4-26 



Relevant to claim No. 



1-21 
1-21 



fl Further documents are listed in the continuation of Box C. Q See patent family annex. 



• Special categories of cited documents: 

"A" document doflnlng the general state of the art which U not ccmldered to be 
of particular relevance 

•B- earlier application or patent published en or after the international filing date 

*L- document which may throw doubts on priority claim(s) or which U died to 
establish the publication date of another citation or other special reason (as 



•O* document referring to on oral disclosure, use, exhibition or other means 

-p» document published prior to the international filing date but later than the 
priority date claimed 



later document published after the international filing date or priority 
date and not in conflict with the application but cited to understand the 
principle or theory underlying the invention 

rinraiffignt of particular relevance; the claimed Invention cannot be 
considered novel or cannot be considered to involve an Inventive step 
when the document Is taken alone 

document of particular relevance; the claimed invention cannot be 
considered to involve an Inventive step when the document U 
combined with one or more other such documents, such combination 
being obvious to a person skilled In the art 

document member of the same patent family 



Date of the actual completion of the international search 
13 December 2001 (13.12.2001) 



Date of mailing of Che 




Name and mailing address of the ISA/US 
Commissioner of Patents and Trademarks 
Box PCT 

Washington, D.C. 20231 

Facsimile No. (703) 305-3230 



Authorized officer 
Afsar M. Qureshi 
Telephone No. (71 



Form PCT/ISA/210 (second sheet) (July 1998) 



